home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / XTG.RAR / XTG / ZEDIT.TXT < prev    next >
Text File  |  1993-08-05  |  55KB  |  1,912 lines

  1.                     Zedit (tm) Version 2.0
  2.  
  3.          Copyright (C) 1990-1993 Executive Systems, Inc.
  4.  
  5.                  All Rights Reserved Worldwide
  6.  
  7.                      by Jeffrey C Johnson
  8.  
  9.     This file contains the following sections:
  10.  
  11.     Installing the Zedit Text Editor
  12.     Starting Zedit
  13.     Command Line Options
  14.     Gang Edit Mode
  15.     Starting Zedit from XTreeGold or XTreeNet
  16.     The Zedit Screen
  17.     Using a Mouse
  18.     File Menu Commands
  19.     Block Menu Commands
  20.     Edit Menu Commands
  21.     Goodies Menu Commands
  22.     Options Menu Commands
  23.     Print Menu Commands
  24.     Search Menu Commands
  25.     Tab Menu Commands
  26.     Window Menu Commands
  27.     Control Key Commands
  28.     CTRL+K Commands
  29.     CTRL+KJ "Mark" Command
  30.     CTRL+O Commands
  31.     CTRL+Q Commands
  32.     Additional Keystroke Commands
  33.     How Backup Files are Generated
  34.     End of Line and End of File Characters
  35.     Inserting Control Codes and Graphics into a File
  36.     The Color Editor
  37.     Zedit Files
  38.     DOS 5, Z.EXE, ZX.EXE and Memory Usage
  39.     EMS and Running Other Programs from within Zedit
  40.  
  41. -----------------------------------------------------------------
  42.     Installing the Zedit Text Editor
  43. -----------------------------------------------------------------
  44.  
  45.     Zedit is automatically installed in your XTGOLD or XTNET
  46.     directory when you install XTreeGold or XTreeNet. To change
  47.     the directory in which Zedit is installed: 
  48.  
  49.     o   Copy all Zedit files to any directory. 
  50.  
  51.     o   Make sure that Z.EXE (or ZX.EXE) is accessible via a
  52.         batch file or the PATH= DOS environment variable.  
  53.  
  54.     See the section, "Zedit Files" for more information.
  55.  
  56. -----------------------------------------------------------------
  57.      Starting Zedit
  58. -----------------------------------------------------------------
  59.  
  60.     Zedit can be started from the DOS command line.
  61.  
  62.     The syntax for starting Zedit is: 
  63.  
  64.         Z [options] [filename(s)] 
  65.  
  66.     Command line options and filename syntax are described in the
  67.     next section. 
  68.  
  69. -----------------------------------------------------------------
  70.     Command Line Options
  71. -----------------------------------------------------------------
  72.  
  73.     The command line options are: 
  74.  
  75. /m  Forces monochrome attributes to be used for menus, the status
  76.     line and dialog boxes, and a single 'monochrome' palette for
  77.     the file windows. Configured color information is ignored
  78.     when /w is specified.  
  79.  
  80. /p  Prints one file and exits to the DOS prompt.
  81.  
  82. /w  Same as the /m switch except a separate set of colors is used
  83.     for the file windows.
  84.  
  85.     TIP: Use /w (and the associated color settings) when using
  86.     Zedit in a DOS window running under Windows. This lets you
  87.     customize one color set and use it for all open files and is
  88.     convenient when the installed Windows Video Grabber Device
  89.     Driver uses non-standard colors in a DOS box. You'll know if
  90.     you need to use this switch if Zedit text becomes unreadable. 
  91.  
  92. OPENING MULTIPLE WINDOWS
  93.  
  94.     These additional command line options control how multiple
  95.     windows are opened when you start Zedit and load multiple
  96.     files. 
  97.  
  98. /c  Opens cascading windows.
  99.  
  100. /h  Splits windows horizontally.
  101.  
  102. /o  Opens windows in an ordered stack.
  103.  
  104. /t  Opens tiled windows.
  105.  
  106. /v  Splits windows vertically.
  107.  
  108. LOADING FILES FROM THE COMMAND LINE
  109.  
  110. Syntax: Z [filename] [[filename] ... [filename]] 
  111.  
  112.     Loads files specified on the command line.
  113.  
  114. Syntax: Z +
  115.  
  116.     Loads the files from the previous editing session. The
  117.     current list of open files is automatically saved in the
  118.     config directory as "ZLIST.HST" when you exit. 
  119.  
  120. Syntax: Z +filename 
  121.  
  122.     Opens each file listed in the specified text file in a window
  123.     when the editing session begins. This option assumes
  124.     "filename" contains a list of files to load into multiple
  125.     windows. You can use XTreeGold to generate this list or
  126.     create it manually. You can also copy or rename the ZLIST.HST
  127.     file that is written when you exit the editor.  
  128.  
  129.     Files loaded in this mode must all fit in memory at one time.  
  130.  
  131. Syntax: Z -filename 
  132.  
  133.     Opens each file listed in the specified text file in Gang
  134.     Edit mode when the editing session begins. This option
  135.     assumes "filename" contains a list of files for Gang Edit
  136.     mode. You can use XTreeGold to generate this list or create
  137.     it manually. You can also copy or rename the ZLIST.HST file
  138.     that is written when you exit the editor.  
  139.  
  140.     The maximum number of files that can be included in a Gang
  141.     Edit are determined by the sum of the memory needed to
  142.     handle the file-list file and the largest file in the list. 
  143.  
  144.     Lines beginning with ';' ' ' '/' are ignored in the file-list
  145.     file.  
  146.  
  147. ASSIGNING TAB SETTINGS TO FILE EXTENSIONS
  148.  
  149.     The ZTABS.INI file specifies how tabs are automatically set
  150.     when a file is loaded into the editor. ZTABS.INI can be
  151.     edited with Zedit, and contains instructions on setting the
  152.     default tabs. 
  153.  
  154. -----------------------------------------------------------------
  155.     Gang Edit Mode
  156. -----------------------------------------------------------------
  157.  
  158.     When the command line syntax takes the form of "Z -filename"
  159.     Zedit reads "filename" into memory, parses it, and then uses
  160.     the parsed file as a list of files to edit. This feature lets
  161.     you edit hundreds of files at one time (Zedit needs enough
  162.     RAM to hold the file-list file and the largest file in the
  163.     list).  
  164.  
  165.     Files are brought into the "Gang Edit window" (which is
  166.     initially window 1) one at a time for editing. Two actions
  167.     cause the editor to automatically advance to the next file:
  168.  
  169.     o   Pressing CTRL+KN, CTRL+KG
  170.  
  171.     o   Searching for text with the Search, Multiple files option
  172.         checked. When a new file is brought into memory, the file
  173.         in the active Gang Edit window is automatically saved if
  174.         it has been modified.  
  175.  
  176.     When a Gang Edit is active, it can be toggled on and off with
  177.     the Options_Gang on/off selection (the second status line
  178.     changes to reflect the change). When the Gang Edit is turned
  179.     off, the Search_Multiple files selection only searches
  180.     through the open windows.  
  181.  
  182.     Pressing CTRL+KI keeps the current Gang Edit file in RAM, and
  183.     opens the next Gang Edit file in the next available window.  
  184.  
  185.     In a Zedit file-list file all lines must contain a valid DOS
  186.     filename, path\filename, or d:\path\filename. Lines that meet
  187.     any of the following criteria are ignored: 
  188.  
  189.     o   blank lines
  190.     o   lines that start with spaces or tabs
  191.     o   lines that start with a semicolon ";"
  192.     o   lines that start with a slash "/"
  193.  
  194. -------------------------------------------------------------
  195.     Starting Zedit from XTreeGold or XTreeNet
  196. -------------------------------------------------------------
  197.  
  198.     To use Zedit instead of 1Word, you'll need to run the
  199.     configuration program and specify it as the default text
  200.     editor.  
  201.  
  202.     In the XTree configuration program, choose Modify
  203.     Configuration Items. Then change the "Editor program" to
  204.     C:\XTGOLD\Z.EXE.  
  205.  
  206.     Once you've changed this, you can use the Edit command to run
  207.     Zedit automatically.  
  208.  
  209.     If you frequently run out of memory when running Zedit from
  210.     XTree, set the memory configuration option for the editor to
  211.     use "ALL MEMORY". 
  212.  
  213.     You can then use the Edit file command to use Zedit from
  214.     XTreeGold or XTreeNet.  
  215.  
  216. -----------------------------------------------------------------
  217.     The Zedit Screen
  218. -----------------------------------------------------------------
  219.  
  220.     In the Zedit screen, two on-screen status lines maintain
  221.     statistics and current editing information. The first line
  222.     under the menu bar shows the current cursor position, by
  223.     line, column and byte. The toggle options checked on the
  224.     Search menu are shown in upper case; those not checked are
  225.     shown in lower case. Once the current file has been edited,
  226.     "Modified" is displayed on this line. The second status line
  227.     shows the Gang Edit status if it is in effect, and the stop
  228.     watch time if a ms stop watch has been turned on. 
  229.  
  230.     When window frames are selected, the window number and file
  231.     name are shown in the top of the window, on the window frame. 
  232.  
  233.     When a file has been modified, the upper left corner of its
  234.     window frame is displayed as a tiny square character instead
  235.     of a box corner.  
  236.  
  237.     NOTE:
  238.  
  239.     The maximum number of open file windows is 80. 
  240.  
  241. -----------------------------------------------------------------
  242.     Using a Mouse
  243. -----------------------------------------------------------------
  244.  
  245.     ╔[1]══════════════════╗ <-- window frame
  246.     ║                     ║
  247.     ║ window text         ║
  248.     ║                     ║
  249.     ╚═════════════════════╝
  250.  
  251. WINDOW FRAMES
  252.  
  253.     BOTH BUTTONS
  254.  
  255.         Clicking either button over the maximize/minimize arrow
  256.         at the upper right corner of a window toggles the window
  257.         between its maximum size and the size you have manually
  258.         set. Note that a copy of the min/max control for the
  259.         active window is located in the upper right corner of the
  260.         screen for convenience. 
  261.  
  262.         Clicking either button over the window id number in its
  263.         upper left corner closes that window. If the file in the
  264.         window has been modified, you are prompted before the
  265.         modified file is discarded.  
  266.  
  267.     LEFT BUTTON 
  268.  
  269.         Dragging any of the four corners resizes the window. The
  270.         position of the text cursor is adjusted to keep the text
  271.         at the cursor position visible within the window.  
  272.  
  273.         Dragging anywhere else on the window frame moves the
  274.         window. 
  275.  
  276.     RIGHT BUTTON 
  277.  
  278.         The right button drags and sizes the window without
  279.         activating the window. Use it to bring a window into view
  280.         or hide it under another window.  
  281.  
  282. WINDOW TEXT
  283.  
  284.     BOTH BUTTONS
  285.  
  286.         Clicking either button over the text of an inactive
  287.         window activates that window (brings it to the top). 
  288.  
  289.     LEFT BUTTON 
  290.  
  291.         Clicking the LEFT button over text in the active window
  292.         moves the cursor (insertion point) to the mouse location.  
  293.  
  294.         Double-clicking the LEFT button over text in the active
  295.         window marks the expression at the cursor location (same
  296.         as CTRL+KJ).  
  297.  
  298.         Double-clicking the LEFT button over text in the active
  299.         window while holding down the CTRL key (1) marks the
  300.         expression at the cursor location (2) moves the cursor to
  301.         the end of the block (3) searches for the next occurrence
  302.         of the marked expression, and (4) unmarks the block.
  303.         (same as CTRL+KJ, CTRL+QK, CTRL+QJ, CTRL+KH).  
  304.  
  305.         Dragging the LEFT button over text in the active window
  306.         marks the text as the cursor moves. If the mouse is
  307.         dragged above or below the window the text scrolls up or
  308.         down.  
  309.  
  310.     RIGHT BUTTON 
  311.  
  312.         Clicking the RIGHT button over text in the active window
  313.         scrolls the text up (when clicking in the upper half of
  314.         the window) and down (when clicking in the lower half of
  315.         the window). If you click in the left four columns of the
  316.         window the text scrolls one page at a time.  
  317.  
  318.         Holding down the RIGHT button initiates a continuous
  319.         scroll. 
  320.  
  321.         Dragging the RIGHT button causes a scroll every time the
  322.         mouse cursor moves.  
  323.  
  324. -----------------------------------------------------------------
  325.     File Menu Commands
  326. -----------------------------------------------------------------
  327.  
  328. Open file and window...
  329.  
  330.     Opens a file in a new window. 
  331.  
  332. Read file into window...
  333.  
  334.     Inserts the file into the current window. 
  335.  
  336. Save 
  337.  
  338.     Saves the current file, whether or not it has been modified. 
  339.  
  340. Save As...
  341.  
  342.     Saves the file with a new file name which you specify. 
  343.  
  344. Save changed, eDit another...
  345.  
  346.     Saves the current file and opens another one in the same
  347.     window. 
  348.  
  349. Save changes, eXit to DOS
  350.  
  351.     Saves all modified files and exits Zedit. Unlike File_Exit
  352.     to DOS, this command automatically saves all modified files
  353.     without prompting.  
  354.  
  355. Save modified Files
  356.  
  357.     Saves all modified files; you are prompted at each file. 
  358.  
  359. Abandon file, edit another...
  360.  
  361.     Abandons the current file and opens another in the current
  362.     window. 
  363.  
  364. Abandon file, close window...
  365.  
  366.     Abandons the current file and closes the current window. If
  367.     the current window is the only open window, it also exits
  368.     Zedit.  
  369.  
  370. Abandon all, exit to DOS...
  371.  
  372.     Abandons all modified files and exits to DOS. Zedit asks for
  373.     confirmation. 
  374.  
  375. About Zedit...
  376.  
  377.     Displays the program version number and copyright notice. 
  378.  
  379. DOS Commands...
  380.  
  381.     Executes a DOS command. If you have 600K free EMS, Zedit will
  382.     use it to save the RAM it uses while the DOS command is
  383.     executing. Otherwise a disk file is used.  
  384.  
  385. Exit to DOS... 
  386.  
  387.     Ends the Zedit session. If you press ESC at the "Save file
  388.     as" prompt, the file is NOT saved, and Zedit does NOT exit to
  389.     DOS; you are returned to Zedit and the canceled file becomes
  390.     the active window.  
  391.  
  392. -----------------------------------------------------------------
  393.     Block Menu Commands 
  394. -----------------------------------------------------------------
  395.  
  396. Copy block
  397.  
  398.     Copies the marked block to the current cursor location. 
  399.  
  400. Delete block
  401.  
  402.     Deletes the marked block. 
  403.  
  404. Move block
  405.  
  406.     Moves the marked block to the current cursor location. 
  407.  
  408. Read block from file 
  409.  
  410.     Reads a file into the current window at the current cursor
  411.     position. 
  412.  
  413. Write block to file 
  414.  
  415.     Writes the marked block to another file. 
  416.  
  417. Indent block 
  418.  
  419.     Indents the block; intended for structured programming
  420.     languages. 
  421.  
  422. Outdent block 
  423.  
  424.     Removes block indenting. 
  425.  
  426. Mark by moving cursor 
  427.  
  428.     Lets you start and stop marking text as you move the cursor
  429.     around. 
  430.  
  431. Mark block start 
  432.  
  433.     Marks the beginning of a text block. 
  434.  
  435. Mark block end 
  436.  
  437.     Marks the end of a text block.  
  438.  
  439. Mark line 
  440.  
  441.     Marks the line at the cursor position. 
  442.  
  443. Mark word - expression 
  444.  
  445.     Marks a block of text. See the section "CTRL+KJ Mark Command."  
  446.  
  447. Unmark 
  448.  
  449.     Removes the block markers from the text. 
  450.  
  451. -----------------------------------------------------------------
  452.     Edit Menu Commands
  453. -----------------------------------------------------------------
  454.  
  455. Append
  456.  
  457.     Appends the marked text to the scrap file. 
  458.  
  459. Copy
  460.  
  461.     Copies the marked text to the scrap file. 
  462.  
  463. Cut
  464.  
  465.     Cuts the marked text to the scrap file. 
  466.  
  467. Paste
  468.  
  469.     Pastes the scrap file into the file at the current cursor
  470.     position. 
  471.  
  472. -----------------------------------------------------------------
  473.     Goodies Menu Commands
  474. -----------------------------------------------------------------
  475.  
  476. Goto line number... 
  477.  
  478.     Moves the cursor to any line number in the current file. 
  479.  
  480. Jump to bookmark
  481.  
  482.     Moves the cursor to bookmark 1 through 4. 
  483.  
  484. Place a bookmark... 
  485.  
  486.     Sets a bookmark from 1 to 4. 
  487.  
  488. Font & ASCII table... 
  489.  
  490.     Displays the PC8 character set. See the section "Inserting
  491.     Control Codes and Graphics into a File."  
  492.  
  493. Insert DOS screen
  494.  
  495.     Inserts the DOS screen into the current file at the cursor
  496.     position. Duplicate blank lines and the prompt at the bottom
  497.     of the screen are not inserted into the file.  
  498.  
  499. Alternate macro set 
  500.  
  501.     Uses the alternate macro set stored in the file ZMAC2.CFG. 
  502.  
  503. Display active macros
  504.  
  505.     Displays the macros in the directory specified by the ZDIR=
  506.     environment variable. 
  507.  
  508. Original macro hot keys 
  509.  
  510.     Sets the macro keys back to the defaults:
  511.  
  512.         record    ALT - 
  513.         playback  ALT + 
  514.         assign    ALT 0 
  515.  
  516.     Note that the macro functions are programmed into the Zedit
  517.     macro files as F7, F8 and ALT+F7. This command frees the
  518.     function keys. 
  519.  
  520. Redefine macro hot keys
  521.  
  522.     Attaches the record, play and assign functions to any ALT
  523.     keys. 
  524.  
  525. NOTES:
  526.  
  527.     To delete a key assignment, assign an empty recording. Zedit
  528.     asks if you want to delete the assignment.  
  529.  
  530.     If you delete the macros for ALT_F ALT_B ALT_G ALT_O ALT_S
  531.     ALT_T ALT_W you will have to reference the pull-down menus as
  532.     "CTRL+P" followed by the 1st letter of the menu bar item; for
  533.     example, to open the File menu, you'll have to press CTRL+PF. 
  534.  
  535. 1 fixup 'c' comments 
  536.  
  537.     Right-justifies one line 'c' comments to the window border.  
  538.  
  539. 2 strip trailing spaces 
  540.  
  541.     Removes trailing white space from the current line. 
  542.  
  543. 3 leading tabs to spaces 
  544.  
  545.     Expands leading tabs to spaces on the current line. 
  546.  
  547. 4 leading spaces to tabs 
  548.  
  549.     Replaces leading tabs with spaces on the current line. 
  550.  
  551. 5 expand tabs to spaces
  552.  
  553.     Expands all tabs to spaces on the current line.  
  554.  
  555. 7 sort file
  556.  
  557.     Reorders each line in the file, in correct alphanumeric order. 
  558.  
  559. 8 delete duplicate lines
  560.  
  561.     Removes duplicate lines from the current file. 
  562.  
  563.     NOTE:
  564.  
  565.     The tab manipulation functions will not cause any visible
  566.     changes in the file display unless the tab size is set to 1.
  567.     To see where the tabs are in the text, setting a tab size of
  568.     1 will display the character for ASCII code 9.  
  569.  
  570. -----------------------------------------------------------------
  571.     Options Menu Commands
  572. -----------------------------------------------------------------
  573.  
  574. 25 line display
  575.  
  576.     Changes the display mode to 25 lines. 
  577.  
  578. 40 line display
  579.  
  580.     Changes the display mode to 40 lines. 
  581.  
  582. Edit colors...
  583.  
  584.     Lets you edit the screen colors. See the section "The Color
  585.     Editor."  
  586.  
  587. Gang edit on/off
  588.  
  589.     When a gang edit is in progress, selecting this option turns
  590.     the gang edit mode on and off. The gang edit status (on/off
  591.     or active window number) is displayed on the second status
  592.     line.  
  593.  
  594. Save configuration
  595.  
  596.     Writes out the following information, which is automatically
  597.     restored the next time you run Zedit: 
  598.  
  599.     o   all colors 
  600.     o   all of the options on the Print menu including the
  601.         "before" and "after" strings 
  602.     o   Window_Framed max 
  603.     o   macro key assignments for Record/Play/Assign 
  604.     o   all of the Search options 
  605.     o   the Options_25/40 line display selection 
  606.  
  607. -----------------------------------------------------------------
  608.     Print Menu Commands
  609. -----------------------------------------------------------------
  610.  
  611. File 
  612.  
  613.     Prints the contents of the file in the current window. 
  614.  
  615. Window contents 
  616.  
  617.     Prints only the visible portion of the text in the current
  618.     window. Use the mouse to frame the text as you want it
  619.     printed.  
  620.  
  621. Clip long lines 
  622.  
  623.     When printing a file, this option causes extra characters
  624.     past the right margin to not be printed. 
  625.  
  626. Headers 
  627.  
  628.     Prints the path and file name, current date and time, and a
  629.     page number at the top of each page.  
  630.  
  631. Indented 
  632.  
  633.     When printing, text is indented 10 spaces from the left
  634.     margin.  
  635.  
  636. Line numbers 
  637.  
  638.     Prints line numbers in the left margin.  
  639.  
  640. 1 Lines...
  641.  
  642.     Lets you specify the number of lines per page. For laser
  643.     printers, this should be one less than the maximum printable
  644.     lines per page.  
  645.  
  646. 2 Columns...
  647.  
  648.     Lets you specify the number of columns across the page. For
  649.     printers that wrap the lines, this should be one less than
  650.     the maximum printable columns per page.  
  651.  
  652. 3 Str before... 
  653.  
  654.     This string, if defined and the first character is not
  655.     chr(255), is sent to the printer BEFORE each Print_File and
  656.     Print_Window operation begins.  
  657.  
  658. 4 Str after...
  659.  
  660.     This string, if defined and the first character is not
  661.     chr(255), is sent to the printer AFTER each Print_File and
  662.     Print_Window operation ends.  
  663.  
  664. -----------------------------------------------------------------
  665.     Search Menu Commands
  666. -----------------------------------------------------------------
  667.  
  668. Repeat Last search 
  669.  
  670.     Performs the search indicated in the Search dialog box. 
  671.  
  672. Replace...
  673.  
  674.     Searches and replaces a string of characters. Use this
  675.     command to replace one string of characters with another.
  676.     Type in the text to be replaced and press ENTER. Then type in
  677.     the new text. The cursor moves to the first occurrence and
  678.     prompts you to confirm the replacement. Press Y to replace
  679.     the text at the cursor. 
  680.  
  681. Search... 
  682.  
  683.     Searches for a string of characters. Type in the text you
  684.     want to find and press ENTER. 
  685.  
  686. Defaults 
  687.  
  688.     Resets the search options to the program defaults.  
  689.  
  690. Ask for replace 
  691.  
  692.     When selected, Zedit asks you before replacing text. 
  693.  
  694. Case sensitive 
  695.  
  696.     When selected, found text must exactly match the search
  697.     string. Otherwise, uppercase and lowercase letters are
  698.     treated as identical.  
  699.  
  700. Fuzzy
  701.  
  702.     When selected, white space is compacted and an asterisk "*"
  703.     will match any characters. For example, "*" will find all
  704.     strings between two quotation marks. 
  705.  
  706. Global replace 
  707.  
  708.     When selected, search and replace operations will
  709.     automatically continue until the cursor returns to the
  710.     original starting position (or ESC is pressed).  
  711.  
  712. Hilite found text
  713.  
  714.     When selected, found text becomes the active marked text
  715.     block. This is especially useful when the Fuzzy search is
  716.     active. 
  717.  
  718. Multiple files 
  719.  
  720.     When selected, and more than one file is loaded into windows,
  721.     or a Gang Edit is in progress, the search will span multiple
  722.     files. When a multiple search fails, the search stops at the
  723.     original starting file and cursor position. For gang edits,
  724.     the search stops at the beginning of the original starting
  725.     file.  
  726.  
  727. Whole words 
  728.  
  729.     When selected, the character(s) to the immediate left and
  730.     right of the found text must be one of the following for the
  731.     search to find a match: 
  732.  
  733.     o   'A' through 'Z' or 'a' through 'z'
  734.     o   '0' through '9'
  735.     o   '_' (the underbar character)
  736.     o   beginning of line
  737.     o   end of line
  738.  
  739.     The search options are saved when the Goodies, Save
  740.     configuration option is selected. 
  741.  
  742. -----------------------------------------------------------------
  743.     Tab Menu Commands
  744. -----------------------------------------------------------------
  745.  
  746. 1..8 columns 
  747.  
  748.     Sets the tab size to the number you select. 
  749.  
  750. Hard 
  751.  
  752.     Sets hard tab mode (every 8 columns). When you press the TAB
  753.     key, you place the TAB ASCII character into the file. The TAB
  754.     key moves the cursor to the next position which is a multiple
  755.     of eight from the left side of the screen. Subsequently, the
  756.     cursor jumps when you move it over that spot. If you delete
  757.     the Tab, text jumps to the left to fill the gap. Hard tabs
  758.     conserve space on your disk. 
  759.  
  760. Soft 
  761.  
  762.     Sets soft tab mode. Soft tabs place spaces in the file,
  763.     rather than characters, so the cursor will not jump when you
  764.     move it over a tab stop. Tab stops are determined by the
  765.     spaces in the line of text directly above the current line.
  766.     When you are indenting a series of lines, press TAB to move
  767.     the cursor directly to the column where the text begins on
  768.     the above line. Soft tabs are useful for programming in
  769.     high-level languages. 
  770.  
  771.     NOTE:
  772.  
  773.     Changes are only applied to the file in the current window.
  774.  
  775. -----------------------------------------------------------------
  776.      Window Menu Commands
  777. -----------------------------------------------------------------
  778.  
  779. Framed max 
  780.  
  781.     Maximizes the active window and toggles framed and unframed
  782.     mode. 
  783.  
  784. Maximize
  785.  
  786.     Toggles the size of the active window between maximized and
  787.     its previous size. 
  788.  
  789. Maxumall
  790.  
  791.     Maximizes all windows. 
  792.  
  793. Next 
  794.  
  795.     Makes the next window in sequence active. 
  796.  
  797. Prev 
  798.  
  799.     Makes the previous window in sequence active. 
  800.  
  801. Swap top 
  802.  
  803.     Toggles between the last two active windows. 
  804.  
  805. All same size 
  806.  
  807.     All windows are resized to the size of the active window. 
  808.  
  809. Cascade 
  810.  
  811.     Windows are arranged on top of each other so all title bars
  812.     and left borders are visible. 
  813.  
  814. Horizontal 
  815.  
  816.     The two most recently active windows are displayed in
  817.     horizontally split windows. 
  818.  
  819. Ordered stack 
  820.  
  821.     Windows are arranged so only the title bars are visible, and
  822.     they are in alphabetic order. 
  823.  
  824. Stack 
  825.  
  826.     Windows are arranged so only the title bars and the active
  827.     window are visible. 
  828.  
  829. Vertical 
  830.  
  831.     The two most recently active windows are displayed in
  832.     vertically split windows. 
  833.  
  834. Tile 
  835.  
  836.     Windows are resized and arranged so all are visible. 
  837.  
  838. Drag & size 
  839.  
  840.     Lets you use the ARROW keys to resize, and CTRL+ARROW keys to
  841.     move the current window. 
  842.  
  843. -----------------------------------------------------------------
  844.     Control Key Commands
  845. -----------------------------------------------------------------
  846.  
  847. Zedit control commands are executed by holding down the CTRL key 
  848. and pressing a letter key. When a command requires two keys the 
  849. second letter key can be pressed with or without holding down 
  850. the CTRL key. For example, pressing CTRL+K followed by CTRL+X is 
  851. equivalent to pressing CTRL+K followed by X.
  852.  
  853. CTRL+A 
  854.  
  855.     Positions the cursor at the beginning of the previous word in
  856.     the file.  
  857.  
  858. CTRL+B
  859.  
  860.     Formats the paragraph.  
  861.  
  862.     Starting with the cursor line, the current paragraph is 
  863.     reformatted based on the left and right margins.  
  864.  
  865.     The right margin is defined as the right edge of the window
  866.     containing the cursor.  
  867.  
  868.     The left margin is dynamic and is based on the cursor
  869.     position at the time CTRL+B is pressed.
  870.  
  871.     The first time CTRL+B is pressed during an editing session,
  872.     you are asked to confirm that word wrap should be activated.
  873.     This prevents you from accidentally pressing CTRL+B and,
  874.     subsequently destroying a block of source code.  
  875.  
  876.     The word wrap reformat function is intended for documenting
  877.     source code and very simple word processing tasks. 
  878.  
  879.     CTRL+B treats the following character sequences in the left
  880.     margins as white space: 
  881.  
  882.     o   <cr>"// " 
  883.     o   <cr>"; " 
  884.     o   <cr>"* "
  885.     o   <cr>"** "
  886.  
  887.     This allows you to format multiple line asm and c comments
  888.     that are encased in a block comment header. For example, you
  889.     can type this... 
  890.  
  891.         /*
  892.         **
  893.         **  This is a block comment that was originally typed on
  894.         **  a single line. Pressing CTRL+B has reformatted the
  895.         **  comment into a multiple line comment.  
  896.         **
  897.         */
  898.  
  899.     ...and reformat the paragraph by pressing CTRL+B.
  900.  
  901. CTRL+C
  902.  
  903.     Scrolls the page down. 
  904.  
  905. CTRL+D
  906.  
  907.     Moves the cursor one position to the right. 
  908.  
  909. CTRL+E
  910.  
  911.     Moves the cursor one position up. 
  912.  
  913. CTRL+F
  914.  
  915.     Moves the cursor one word (or text string) to the right. 
  916.  
  917. CTRL+G
  918.  
  919.     Deletes the character under the cursor. 
  920.  
  921. CTRL+H
  922.  
  923.     Deletes the character to the left of the cursor. 
  924.  
  925. CTRL+I
  926.  
  927.     Inserts a tab into the file at the cursor location. 
  928.  
  929. CTRL+J
  930.  
  931.     Inserts a <CR> at the cursor location. 
  932.  
  933. CTRL+K
  934.  
  935.     Initiates Wordstar-style file and block commands. See the
  936.     section "CTRL+K Commands."  
  937.  
  938. CTRL+L
  939.  
  940.     Repeats the previous search command. 
  941.  
  942. CTRL+M
  943.  
  944.     Produces the same result as pressing ENTER. 
  945.  
  946. CTRL+N
  947.  
  948.     Produces the same result as pressing ENTER and then the LEFT
  949.     ARROW key. 
  950.  
  951. CTRL+O
  952.  
  953.     Initiates Wordstar-style options commands. See the section
  954.     "CTRL+O Commands."  
  955.  
  956. CTRL+P
  957.  
  958.     Opens the menu specified by the next keystroke. Press ENTER 
  959.     to open the previous menu. 
  960.  
  961. CTRL+Q
  962.  
  963.     Initiates Wordstar-style "quick" menu commands. See the
  964.     section, "CTRL+Q Commands."  
  965.  
  966. CTRL+R
  967.  
  968.     Moves the cursor one page up. 
  969.  
  970. CTRL+S
  971.  
  972.     Moves the cursor one position to the left. 
  973.  
  974. CTRL+T
  975.  
  976.     Deletes the characters from the cursor position up to, but
  977.     not including the first character of the next word to the
  978.     right of the cursor. 
  979.  
  980. CTRL+W
  981.  
  982.     Scrolls the window up. 
  983.  
  984. CTRL+X
  985.  
  986.     Moves the cursor down one line. 
  987.  
  988. CTRL+Y
  989.  
  990.     Deletes the line the cursor is in. 
  991.  
  992. CTRL+Z
  993.  
  994.     Scrolls the window down. 
  995.  
  996. -----------------------------------------------------------------
  997.      CTRL+K Commands
  998. -----------------------------------------------------------------
  999.  
  1000. CTRL+KA
  1001.  
  1002.     Saves the current file; you are prompted for a file name. 
  1003.  
  1004. CTRL+KB
  1005.  
  1006.     Marks the beginning of a block of text.  
  1007.  
  1008. CTRL+KC
  1009.  
  1010.     Copies the marked block. 
  1011.  
  1012. CTRL+KD
  1013.  
  1014.     Saves the current file and opens another file in the same
  1015.     window. 
  1016.  
  1017. CTRL+KE
  1018.  
  1019.     Exits Zedit and prompts you to save each modified file. When
  1020.     prompted, press ENTER to save the file or ESC to NOT save the
  1021.     file and NOT exit Zedit. 
  1022.  
  1023. CTRL+KF
  1024.  
  1025.     Saves all modified files without prompting. 
  1026.  
  1027. CTRL+KG
  1028.  
  1029.     Loads the previous file in the Gang file list. If the current
  1030.     file has been modified, it is automatically saved.  
  1031.  
  1032. CTRL+KH
  1033.  
  1034.     Removes the block markers from the text.  
  1035.  
  1036. CTRL+KI
  1037.  
  1038.     Keeps the current Gang Edit file in RAM, and opens the next
  1039.     Gang Edit file in another window.  
  1040.  
  1041. CTRL+KJ
  1042.  
  1043.     Marks a block of text. See the following section "CTRL+KJ
  1044.     Mark Command."  
  1045.  
  1046. CTRL+KK
  1047.  
  1048.     Marks the end of a text block.  
  1049.  
  1050. CTRL+KL
  1051.  
  1052.     Marks the line at the cursor position. 
  1053.  
  1054. CTRL+KM
  1055.  
  1056.     Lets you start and stop marking text as you move the cursor
  1057.     around. 
  1058.  
  1059. CTRL+KN
  1060.  
  1061.     Loads the next file in the Gang Edit file list.  
  1062.  
  1063. CTRL+KO
  1064.  
  1065.     Opens another window and file for editing. 
  1066.  
  1067. CTRL+KP
  1068.  
  1069.     Abandons the current file and closes the current window. If
  1070.     the current window is the only open window, the Zedit session
  1071.     ends. 
  1072.  
  1073. CTRL+KQ
  1074.  
  1075.     Abandons the current file and opens another in the current
  1076.     window.
  1077.  
  1078. CTRL+KR
  1079.  
  1080.     Reads a file into the current window at the cursor position.  
  1081.  
  1082. CTRL+KS
  1083.  
  1084.     Saves the current file, whether or not it has been modified. 
  1085.  
  1086. CTRL+KT
  1087.  
  1088.     Indents the block; intended for structured programming
  1089.     languages. 
  1090.  
  1091. CTRL+KU
  1092.  
  1093.     Removes the block indenting; intended for structured
  1094.     programming languages. 
  1095.  
  1096. CTRL+KV
  1097.  
  1098.     Moves the marked block to the cursor position. 
  1099.  
  1100. CTRL+KW
  1101.  
  1102.     Writes the marked block to another file. 
  1103.  
  1104.     WRITE: Replaces the specified file with the currently marked
  1105.     block.  
  1106.  
  1107.     APPEND: Adds the currently marked block to the end of the
  1108.     specified file. End the "Write block" dialog by pressing
  1109.     CTRL+ENTER to append the block instead of overwriting the
  1110.     file.  
  1111.  
  1112.     For both operations, if the specified file was already loaded
  1113.     into the editor, the in-RAM copy is updated as is the file on
  1114.     disk.  
  1115.  
  1116. CTRL+KX
  1117.  
  1118.     Saves all modified files and ends the Zedit session. Unlike
  1119.     the File_Exit to DOS command (pre-assigned to ALT+X), CTRL+KX
  1120.     automatically saves all modified files without prompting.  
  1121.  
  1122. CTRL+KY
  1123.  
  1124.     Delete the marked block. 
  1125.  
  1126. CTRL+KZ
  1127.  
  1128.     Abandons all modified files and exits. Zedit prompts you for
  1129.     confirmation before exiting to DOS.  
  1130.  
  1131. CTRL+K 1
  1132.  
  1133.     Sets bookmark 1.
  1134.  
  1135. CTRL+K 2
  1136.  
  1137.     Sets bookmark 2.
  1138.  
  1139. CTRL+K 3
  1140.  
  1141.     Sets bookmark 3.
  1142.  
  1143. CTRL+K 4
  1144.  
  1145.     Sets bookmark 4.
  1146.  
  1147. -----------------------------------------------------------------
  1148.     CTRL+KJ Mark Command
  1149. -----------------------------------------------------------------
  1150.  
  1151.     The CTRL+KJ CTRL sequence provides an all purpose block
  1152.     marking command which can speed up source code editing by a
  1153.     factor of two by eliminating redundant typing and typos. 
  1154.  
  1155.     The best way to explain how it works is by example. Assuming
  1156.     that the <RECORD MACRO> and <PLAYBACK MACRO> functions are
  1157.     assigned to F7 and F8 respectively, record the following
  1158.     keystrokes: 
  1159.  
  1160.         KEYSTROKE       DESCRIPTION
  1161.  
  1162.         F7              Start recording
  1163.         RIGHT_ARROW     Move the cursor right
  1164.         CTRL+K          CTRL+K prefix
  1165.         J               Mark expression
  1166.         ESC or F7       Stop recording
  1167.  
  1168.     Now, place the cursor at the beginning of the examples that
  1169.     follow (in the on-line ZEDIT.TXT file) and press F8 <PLAYBACK
  1170.     MACRO> to move the cursor through and mark the text:
  1171.     
  1172.     #if A 
  1173.     { 
  1174.         #if B 
  1175.         { 
  1176.             /* {[( /* */ { } ( ) [ ] " '?' " #if #endif )]} */
  1177.  
  1178.             if ((XTree.Gold[version] == 3) || (! XTree_Easy[hho]))
  1179.             {
  1180.                 if (XTree_Prune( "NORTON", "PRUNE" ) == OKAY)
  1181.                 {
  1182.                     XTree_Dialog( "Wise choice!" );
  1183.                 }
  1184.                 else
  1185.                 {
  1186.                     XTree_Dialog( "Is Todd in the room?" );
  1187.                 }
  1188.                 something=boolean?yes:no;
  1189.             }
  1190.         }
  1191.         #endif
  1192.     }
  1193.     #endif
  1194.  
  1195.     ?FOO    PROC    NEAR    ;
  1196.             JZ      @F      ;
  1197.             CALL    ?BAR    ;
  1198.             @@:             ;
  1199.     ?FOO    ENDP            ;
  1200.  
  1201.     /*
  1202.     ** Be aware that there is a conflict between C and ASSEMBLER
  1203.     ** involving the question mark. When the cursor is over 
  1204.     ** "FOO" or "BAR" the "?" does not get marked as part of the
  1205.     ** word. When you need to search for an asm symbol with a
  1206.     ** question mark, mark the symbol by hand, and then press 
  1207.     ** CTRL+Q CTRL+J. 
  1208.     ** The editor checks for the following chars (in a lookup    
  1209.     ** table) when deciding if a character is part of a "whole"
  1210.     ** word: 
  1211.     ** "A..Z" "a..z" "0..9" "_" "@" "#"
  1212.     **
  1213.     */
  1214.  
  1215. -----------------------------------------------------------------
  1216.     CTRL+O Commands
  1217. -----------------------------------------------------------------
  1218.  
  1219. CTRL+OA
  1220.  
  1221.     Toggles search and replace prompt mode. When ON, Zedit
  1222.     prompts you before replacing found text.  
  1223.  
  1224. CTRL+OB
  1225.  
  1226.     Useful for 'c' programmers, it constructs a file containing
  1227.     the function declarations in the current file.  
  1228.  
  1229. CTRL+OC
  1230.  
  1231.     Toggles case sensitivity during a search. When ON, found text
  1232.     must exactly match the search string.  
  1233.  
  1234. CTRL+OD
  1235.  
  1236.     Executes a DOS command. If you have 600K free EMS, Zedit will
  1237.     use it to save the RAM it uses while the DOS command is
  1238.     executing. Otherwise a disk file is used.  
  1239.  
  1240.     NOTE:
  1241.  
  1242.     The contents of the DOS screen can be viewed at any time the
  1243.     editor is idle by holding both the CTRL and ALT keys at the
  1244.     same time.  
  1245.  
  1246. CTRL+OF
  1247.  
  1248.     Toggles a fuzzy search. When ON, the search logic is
  1249.     identical to the XTreeGold CTRL+Search command. 
  1250.  
  1251. CTRL+OG
  1252.  
  1253.     Toggles global search and replace. When ON, Zedit will
  1254.     automatically repeat the search and replace command until you
  1255.     press ESC or the starting cursor position is reached.  
  1256.  
  1257. CTRL+OI
  1258.  
  1259.     Inserts the DOS screen into the current file at the cursor
  1260.     position. Duplicate blank lines and the prompt at the bottom
  1261.     of the screen are not inserted into the file.  
  1262.  
  1263. CTRL+OM
  1264.  
  1265.     Toggles search additional windows or files mode. When ON,
  1266.     Zedit continues a search in the next open window (for Gang
  1267.     Edits, the search continues in the next file in the list).  
  1268.  
  1269. CTRL+ON
  1270.  
  1271.     Saves a pointer to the current filename in an internal buffer.
  1272.     That saved name can then be pasted into any open file with
  1273.     the CTRL+OP command. 
  1274.  
  1275. CTRL+OP
  1276.  
  1277.     Pastes the name set by CTRL+ON into the current file at the
  1278.     cursor position. 
  1279.  
  1280. CTRL+OT
  1281.  
  1282.     Inserts the current date and time into file at the cursor
  1283.     position.  
  1284.  
  1285. CTRL+OW
  1286.  
  1287.     Toggles search exclude alphanumeric characters mode. When ON,
  1288.     the start and end of the found text cannot be one of the
  1289.     following characters: A..Z, _, 0..9.  
  1290.  
  1291. CTRL+O 1
  1292.  
  1293.     Displays the current file. Intended for use in macros when
  1294.     you want to watch the progress of a long series of keystrokes
  1295.     while the macro is playing back.  
  1296.  
  1297. -----------------------------------------------------------------
  1298.     CTRL+Q Commands
  1299. -----------------------------------------------------------------
  1300.  
  1301. CTRL+QA
  1302.  
  1303.     Searches and replaces a string of characters. Use this
  1304.     command to replace one string of characters with another.
  1305.     Type in the text to be replaced and press ENTER. Then type in
  1306.     the new text. The cursor moves to the first occurrence and
  1307.     prompts you to confirm the replacement. Press Y to replace
  1308.     the text at the cursor. 
  1309.  
  1310. CTRL+QB
  1311.  
  1312.     Moves the cursor to the start of the marked block. If
  1313.     necessary, the window containing the block is activated.  
  1314.  
  1315. CTRL+QC
  1316.  
  1317.     Moves the cursor to the end of the current file. 
  1318.  
  1319. CTRL+QD
  1320.  
  1321.     Moves the cursor to the end of the current line. 
  1322.  
  1323. CTRL+QF
  1324.  
  1325.     Searches for a string of characters. Type in the text you
  1326.     want to find and press ENTER. The cursor moves to the first
  1327.     occurrence. Press CTRL+L to move the cursor to subsequent
  1328.     occurrences. 
  1329.  
  1330. CTRL+QG
  1331.  
  1332.     Moves the cursor to any line number in the current file. 
  1333.  
  1334. CTRL+QI
  1335.  
  1336.     Sets a bookmark from 1 to 4. 
  1337.  
  1338. CTRL+QJ
  1339.  
  1340.     Searches for the next occurrence of the text defined by the
  1341.     currently marked block. The block must be all on one line,
  1342.     and no longer than 50 characters. If a block is not marked,
  1343.     CTRL+KJ (mark expression) is performed for you to
  1344.     automatically search for the expression at the cursor
  1345.     position.  
  1346.  
  1347.     A typical use of the function is CTRL+KJ, CTRL+QJ: Mark the
  1348.     expression at the cursor and then search for the next
  1349.     occurrence.  
  1350.  
  1351. CTRL+QK
  1352.  
  1353.     Moves the cursor to the end of the marked block. If
  1354.     necessary, the window containing the block is activated.  
  1355.  
  1356. CTRL+QL
  1357.  
  1358.     Converts the character under the cursor to lower case. 
  1359.  
  1360. CTRL+QM
  1361.  
  1362.     Converts the current line to upper case, then moves the
  1363.     cursor down one line. 
  1364.  
  1365. CTRL+QN
  1366.  
  1367.     Converts the current line to lower case, then moves the
  1368.     cursor down one line. 
  1369.  
  1370. CTRL+QO
  1371.  
  1372.     Toggles the cursor position between the set of bookmarks most
  1373.     recently used. If necessary, the window containing the
  1374.     bookmark is activated.  
  1375.  
  1376. CTRL+QP
  1377.  
  1378.     Moves the cursor to the Q bookmark (Quickmark). If necessary,
  1379.     the window containing the bookmark is activated. 
  1380.  
  1381. CTRL+QQ
  1382.  
  1383.     Sets the Q bookmark (Quickmark). You can jump to this
  1384.     position at any time by pressing CTRL+QP. 
  1385.  
  1386. CTRL+QR
  1387.  
  1388.     Moves the cursor to the beginning of the current file. 
  1389.  
  1390. CTRL+QS
  1391.  
  1392.     Moves the cursor to the beginning of the current line. 
  1393.  
  1394. CTRL+QU
  1395.  
  1396.     Converts the character under the cursor to upper case. 
  1397.  
  1398. CTRL+QY
  1399.  
  1400.     Deletes the right portion of the current line, from the
  1401.     cursor to the end. 
  1402.  
  1403. CTRL+Q 1
  1404.  
  1405.     Moves the cursor to bookmark 1. See CTRL+K1.
  1406.  
  1407. CTRL+Q 2
  1408.  
  1409.     Moves the cursor to bookmark 2. See CTRL+K2.
  1410.  
  1411. CTRL+Q 3
  1412.  
  1413.     Moves the cursor to bookmark 3. See CTRL+K3.
  1414.  
  1415. CTRL+Q 4
  1416.  
  1417.     Moves the cursor to bookmark 4. See CTRL+K4.
  1418.  
  1419. -----------------------------------------------------------------
  1420.     Additional Keystroke Commands
  1421. -----------------------------------------------------------------
  1422.  
  1423. ESC
  1424.  
  1425.     Stops macro recording, when the editor is idle and you can
  1426.     enter text into the file. 
  1427.  
  1428. ALT_#
  1429.  
  1430.     ALT_1 through ALT_8 (across the top of the keyboard) moves
  1431.     windows 1..8 to the front.  
  1432.  
  1433. UP ARROW
  1434.  
  1435.     Moves the cursor up one line. 
  1436.  
  1437. DOWN ARROW
  1438.  
  1439.     Moves the cursor down one line. 
  1440.  
  1441. LEFT ARROW
  1442.  
  1443.     Moves the cursor left one character. 
  1444.  
  1445. RIGHT ARROW
  1446.  
  1447.     Moves the cursor right one character. 
  1448.  
  1449. HOME
  1450.  
  1451.     Moves the cursor to the beginning of the line. 
  1452.  
  1453. END
  1454.  
  1455.     Moves the cursor to the end of the line. 
  1456.  
  1457. PGUP
  1458.  
  1459.     Moves the cursor to the previous screen. 
  1460.  
  1461. PGDN
  1462.  
  1463.     Moves the cursor to the next screen. 
  1464.  
  1465. CTRL+HOME
  1466.  
  1467.     Moves the cursor to the beginning of the file. 
  1468.  
  1469. CTRL+END
  1470.  
  1471.     Moves the cursor to the end of the file. 
  1472.  
  1473. CTRL+LEFT ARROW
  1474.  
  1475.     Moves the cursor to the previous word.  
  1476.  
  1477. CTRL+RIGHT ARROW
  1478.  
  1479.     Moves the cursor to the next word.  
  1480.  
  1481. INS
  1482.  
  1483.     Toggles Insert/Overstrike mode. 
  1484.  
  1485. DEL
  1486.  
  1487.     Deletes the character under the cursor. 
  1488.  
  1489. SHIFT+ARROWS/HOME/END/PGUP/PGDN
  1490.  
  1491.     Performs word-processor style text marking. Text is marked as
  1492.     you move the cursor while holding down the SHIFT key. 
  1493.  
  1494. SHIFT+DEL
  1495.  
  1496.     Cuts the marked text to the scrap file. 
  1497.  
  1498. SHIFT+INS
  1499.  
  1500.     Pastes the scrap file into the current file at the cursor
  1501.     position. 
  1502.  
  1503. SHIFT++ (the plus key on the number pad)
  1504.  
  1505.     Copies the marked text to the scrap file. 
  1506.  
  1507. SHIFT+- (the minus key on the number pad)
  1508.  
  1509.     Appends the marked text to the scrap file. 
  1510.  
  1511.     NOTE:
  1512.  
  1513.     The scrap file, ZSCRAP.TXT, is not treated in any special way
  1514.     by the program other than automatically supplying the file
  1515.     open/write/close code a filename. When the file is saved (via
  1516.     a copy/append/cut operation) it gets the same double-backup
  1517.     treatment as files you are editing. This allows you to
  1518.     recover scrap text from either the PRIMARY or SECONDARY
  1519.     backup file when desired. 
  1520.  
  1521.     Also, the file is not cached in RAM. This allows you to share
  1522.     data between multiple instances of the program running under 
  1523.     a multitasker. And, the performance of the SHIFT+DEL "cut to 
  1524.     scrap" function is greatly enhanced when you have a disk cache 
  1525.     installed that is caching disk writes.  
  1526.  
  1527.     CAUTION: 
  1528.  
  1529.     The SHIFT+DEL "cut to scrap" will cut a block to the scrap
  1530.     file when marked blocks are not visible on the screen.  
  1531.  
  1532. CTRL+SHIFT+A through CTRL+SHIFT+Z
  1533.  
  1534.     Inserts that ASCII character code into the file.  
  1535.  
  1536. -----------------------------------------------------------------
  1537.     How Backup Files are Generated
  1538. -----------------------------------------------------------------
  1539.  
  1540.     Zedit uses a double-backup system when files are saved. The
  1541.     first time a file is saved, a PRIMARY backup file is
  1542.     generated with the file's extension backfilled with a tilde
  1543.     (~) character. Subsequent saves generate a SECONDARY backup
  1544.     file with the file's extension backfilled with an underbar
  1545.     (_) character.  
  1546.  
  1547.     The SECONDARY backup always contains the version of the file
  1548.     immediately before it was last saved. The PRIMARY backup
  1549.     always contains the original file. When you know that
  1550.     modified files are in a state you want to keep, delete the
  1551.     PRIMARY backup files using XTreeGold or XTreeNet.  
  1552.  
  1553.     This double-backup can save countless hours under various
  1554.     editing conditions, especially after mass editing sessions
  1555.     which last for more than a day, or when multiple files are
  1556.     saved multiple times. The method also keeps unique backups
  1557.     when files in the same directory have the same name but
  1558.     different extensions (for example, FOO.C and FOO.H).  
  1559.  
  1560.     ORIGINAL    PRIMARY     SECONDARY
  1561.     FILENAME    BACKUP      BACKUP
  1562.  
  1563.     FOO         FOO.~~~     FOO.___
  1564.     FOO.A       FOO.A~~     FOO.A__
  1565.     FOO.C       FOO.C~~     FOO.C__
  1566.     FOO.1       FOO.1~~     FOO.1__
  1567.     FOO.AB      FOO.AB~     FOO.AB_
  1568.     FOO.CD      FOO.CD~     FOO.CD_
  1569.     FOO.12      FOO.12~     FOO.12_
  1570.     FOO.ABC     FOO.AB~     FOO.AB_
  1571.     FOO.DEF     FOO.DE~     FOO.DE_
  1572.     FOO.123     FOO.12~     FOO.12_
  1573.  
  1574.     FOO.AB1     FOO.AB~     FOO.AB_
  1575.     FOO.AB2     FOO.AB~     FOO.AB_
  1576.  
  1577.     The example FOO.AB1 and FOO.AB2 shows where the backfill
  1578.     method falls short. Both files will have the same backup
  1579.     names. This, however, is a rare occurrence with text filenames. 
  1580.  
  1581. -----------------------------------------------------------------
  1582.     End of Line and End of File Characters
  1583. -----------------------------------------------------------------
  1584.  
  1585.     Zedit reads files with any known combination of line
  1586.     termination characters as follows: 
  1587.  
  1588.     <cr>           one line
  1589.     <lf>           one line
  1590.     <cr><lf>       one line
  1591.     NULL           one line
  1592.     <cr><cr>       two lines
  1593.     <cr><cr><lf>   two lines
  1594.     <lf><lf>       two lines
  1595.     <cr><lf><lf>   two lines
  1596.  
  1597.     When the last byte of a file is an <eof> character, that
  1598.     character is discarded. <eof> characters found in the middle
  1599.     of the file are kept.  
  1600.  
  1601. -----------------------------------------------------------------
  1602.     Inserting Control Codes and Graphics into a File
  1603. -----------------------------------------------------------------
  1604.  
  1605.     Zedit allows all of the PC8 character set to be visibly
  1606.     inserted into a file with four exceptions: 
  1607.  
  1608.     CHR( 0 )  null values are ignored
  1609.  
  1610.     CHR( 9 )  tabs are treated as tab stops
  1611.  
  1612.     CHR( 10 ) line feed (CTRL+J or CTRL+ENTER) ends a line
  1613.  
  1614.     CHR( 13 ) carriage return (CTRL+M or ENTER) ends a line
  1615.  
  1616.     Any other 8 bit value can be inserted into a file by holding
  1617.     down the ALT key while typing the decimal value for the value
  1618.     on the numeric keypad. (This is a standard feature of the PC
  1619.     BIOS). 
  1620.  
  1621.     Also, the character codes between chr(1) and chr(31) can be
  1622.     entered by pressing CTRL+SHIFT+'A..Z' (and a few other keys).  
  1623.  
  1624.     EXAMPLES:
  1625.  
  1626.     To enter the paragraph symbol (): 
  1627.  
  1628.     1. Hold down the ALT key
  1629.     2. On the numeric key pad type "20"
  1630.     3. Release the ALT key
  1631.          -or-
  1632.     1. Hold down both the CTRL and ALT keys
  1633.     2. Press the T key (CTRL+SHIFT+T)
  1634.  
  1635.     To enter the check mark symbol (√): 
  1636.  
  1637.     1. Hold down the ALT key
  1638.     2. On the numeric key pad type "251"
  1639.     3. Release the ALT key
  1640.  
  1641. TIP: 
  1642.  
  1643.     The Zedit Goodies_Font command displays the complete
  1644.     PC8 character set for reference. 
  1645.  
  1646. NOTES:
  1647.  
  1648.     If your keyboard has more that one ALT, CTRL or SHIFT key,
  1649.     only one of each needs to be pressed. 
  1650.  
  1651.     Be aware that entering "non-ASCII" characters into files can
  1652.     cause problems in other programs; the characters may have
  1653.     special meanings to other programs and produce unpredictable
  1654.     results.  
  1655.  
  1656.     The same caution applies to printers. In almost all cases,
  1657.     entering an ESC code (chr(27)) into a file at random will
  1658.     stop the printer (and therefore the resulting printing of the
  1659.     file). You can, however, use the ESC code (followed by other
  1660.     printer-specific codes) to initialize the printer and change
  1661.     fonts. 
  1662.  
  1663. -----------------------------------------------------------------
  1664.     The Color Editor
  1665. -----------------------------------------------------------------
  1666.  
  1667.     The default Zedit colors are set for a VGA monitor. If you
  1668.     are using an EGA or CGA monitor, the colors will need
  1669.     resetting. When Zedit initializes with a black and white VGA
  1670.     monitor installed, it re-programs the gray colors and makes
  1671.     the bright magenta a bright gray (allowing you to use three
  1672.     shades of gray (plus white) instead of two).  
  1673.  
  1674.     Zedit has 15 file window color sets; 13 for color and one
  1675.     each for monochrome and paper-white displays. The monochrome
  1676.     set (/m command line switch) is indicated as "Color set: 14"
  1677.     in the color editor display and the paper white set (/w
  1678.     command line switch) is "Color set: 15."  
  1679.  
  1680.     When colors are in use, color sets are pre-assigned to the
  1681.     file windows. To see all of the color sets, open up 13
  1682.     (small) files and select Window_Tile. To change a color set,
  1683.     activate a window and select Goodies_Colors. To save
  1684.     modified colors, select Options_Save configuration.  
  1685.  
  1686.     If you want all of the windows to have the same colors, use
  1687.     the Copy and Paste keyboard functions to assign the colors to
  1688.     all 13 sets.  
  1689.  
  1690. MOUSE TECHNIQUES
  1691.  
  1692. LEFT BUTTON 
  1693.  
  1694.     Select a color to edit from the "picture" of the program
  1695.     screen.  
  1696.  
  1697.     -or- 
  1698.  
  1699.     Click the left color stripe to choose the character color for
  1700.     the selected picture element. 
  1701.  
  1702.     -or- 
  1703.  
  1704.     Click the right color stripe to choose the background color
  1705.     for the selected picture element.  
  1706.  
  1707. RIGHT BUTTON 
  1708.  
  1709.     Click anywhere to accept the changes. 
  1710.  
  1711.     The color editor only works with the mouse, with a few
  1712.     exceptions, as shown in this list. 
  1713.  
  1714. KEYS
  1715.  
  1716. C
  1717.  
  1718.     Copies the current color set to a temp buffer. 
  1719.  
  1720. P
  1721.  
  1722.     Pastes the copied colors. 
  1723.  
  1724. UP ARROW
  1725.  
  1726.     Changes the current character color (-). 
  1727.  
  1728. DOWN ARROW
  1729.  
  1730.     Changes the current character color (+).  
  1731.  
  1732. LEFT ARROW
  1733.  
  1734.     Changes the current background color (-). 
  1735.  
  1736. RIGHT ARROW
  1737.  
  1738.     Changes the current background color (+). 
  1739.  
  1740. Number pad - (Minus key)
  1741.  
  1742.     Cycles backwards through the editable colors. 
  1743.  
  1744. Number pad + (Plus key)
  1745.  
  1746.     Cycles forward through the editable colors 
  1747.  
  1748. PGUP
  1749.  
  1750.     Cycles backwards through the editable colors. 
  1751.  
  1752. PGDN
  1753.  
  1754.     Cycles forward through the editable colors. 
  1755.  
  1756. SPACE
  1757.  
  1758.     Cycles forward through the editable colors. 
  1759.  
  1760. ENTER
  1761.  
  1762.     Accepts any changes. 
  1763.  
  1764. ESC
  1765.  
  1766.     Cancels any changes to the current color set. 
  1767.  
  1768. HOME
  1769.  
  1770.     Accepts any changes, moves to the previous window color set. 
  1771.  
  1772. END
  1773.  
  1774.     Accepts any changes, moves to the next window color set.  
  1775.  
  1776. NOTES:
  1777.  
  1778.     The /M command line switch must be used to edit color set 14
  1779.     (the monochrome colors) if you do not have a monochrome
  1780.     monitor. 
  1781.  
  1782.     The /W command line switch must be used to edit color set 15
  1783.     (the paper white colors).
  1784.  
  1785.     And, be aware that these two color sets share the same colors
  1786.     for the pull-down menus, dialog boxes, dialog buttons, and
  1787.     screen background. These are set up to work correctly on a
  1788.     monochrome adapter and should not be changed if you will be
  1789.     using the same configuration on multiple video systems.  
  1790.  
  1791. -----------------------------------------------------------------
  1792.     Zedit Files
  1793. -----------------------------------------------------------------
  1794.  
  1795.     The following files are Zedit config and macro files. The HST
  1796.     and ZMAC files automatically change as you use the program.  
  1797.  
  1798.         ZEXEC.HST   DOS shell command input history
  1799.         ZFILE.HST   file open input history
  1800.         ZMISC.HST   search and miscellaneous input history
  1801.         ZLIST.HST   list of most recently edited files
  1802.         ZMAC1.CFG   primary macro set
  1803.         ZMAC2.CFG   alternate macro set w/PC characters
  1804.         ZTABS.INI   default tab definitions
  1805.  
  1806.     Also note that ZX.EXE is a non-overlaid version of the
  1807.     editor, but is otherwise identical. It is included in case
  1808.     the overlay manager's use of memory or method of opening
  1809.     files conflicts with your system.  
  1810.  
  1811.     However, Z.EXE is the preferred executable, since it makes
  1812.     better use of memory resources and leaves more memory for
  1813.     editing files.  
  1814.  
  1815. NOTES:
  1816.  
  1817.     If Z.CFG, the macro files, and the history files have been
  1818.     copied to a directory other than the directory that Z.EXE was
  1819.     copied to, you must set the DOS environment variable ZDIR= to
  1820.     point to the directory containing those files.  
  1821.  
  1822.     Zedit searches directories for Z.CFG, Zxxxx.HST and the macro
  1823.     files in the following order: 
  1824.  
  1825.     o   ZDIR= environment variable. 
  1826.  
  1827.     o   The same directory that Z.EXE was executed from. 
  1828.  
  1829.     o   The same directory that Z.EXE was executed from with
  1830.         "\CFG" added to that path.  
  1831.  
  1832.     Therefore, if you have a directory called C:\BIN in your
  1833.     path, and you do not want to create or modify any batch files
  1834.     to install Zedit, then Z.EXE (and/or ZX.EXE) can be copied to
  1835.     C:\BIN and the config files and macro files can be copied to
  1836.     either C:\BIN or C:\BIN\CFG.  
  1837.  
  1838. -----------------------------------------------------------------
  1839.     DOS 5, Z.EXE, ZX.EXE and Memory Usage
  1840. -----------------------------------------------------------------
  1841.  
  1842.     The amount of memory available for editing files is displayed
  1843.     in the upper right corner of the screen next to the date.  
  1844.  
  1845.     Use the CTRL+END command and look at the "Byte nnn" field on
  1846.     the status line to see the size of the current file.  
  1847.  
  1848. Z.EXE
  1849.  
  1850.     When DOS upper memory UMB support is available, the Z.EXE
  1851.     code cache, history buffers, and screen buffers get placed in
  1852.     upper memory allowing the maximum available memory for
  1853.     editing files and executing programs from within Zedit.  
  1854.  
  1855. ZX.EXE
  1856.  
  1857.     ZX doesn't have a code cache and runs about 10% faster than Z.  
  1858.  
  1859.     ZX should be used in place of Z under the following
  1860.     conditions: 
  1861.  
  1862.     o   Z.EXE is slow on your machine.
  1863.  
  1864.     o   Z.EXE causes problems with a TSR or networking software.
  1865.  
  1866. -----------------------------------------------------------------
  1867.      EMS and Running Other Programs from within Zedit
  1868. -----------------------------------------------------------------
  1869.  
  1870. FREEING UP RAM TO EXEC OTHER PROGRAMS
  1871.  
  1872.     When you invoke the File_COMMAND.COM function (CTRL+OD shell
  1873.     out to DOS), Zedit needs to free up RAM by storing the
  1874.     buffers containing the files you are editing in either EMS or
  1875.     a disk file. The required storage space is dependent upon the
  1876.     size of the files and can be anywhere from 50K to 600K bytes.
  1877.  
  1878. WITH EMS
  1879.  
  1880.     If your system has enough available EMS to hold the file
  1881.     buffers, then Zedit will perform exec functions as fast as 
  1882.     COMMAND.COM can be re-invoked. See your DOS reference manual
  1883.     for instructions on setting up an EMS emulator. 
  1884.  
  1885. WITHOUT EMS
  1886.  
  1887.     If your system does NOT have enough EMS to hold the file
  1888.     buffers, then Zedit will store the file buffers in a
  1889.     temporary file in the same directory that holds your config
  1890.     and macro files.  
  1891.  
  1892.     If you want to place the temp file on a RAM disk, then set
  1893.     ZTEMP= in your environment space. Be aware, however, that
  1894.     the RAM disk may need up to 600K bytes of free space.  
  1895.  
  1896. INVOKING COMMAND.COM
  1897.  
  1898.     If you simply want to get to the DOS prompt, enter a blank
  1899.     line at the "Enter DOS command" prompt.  
  1900.  
  1901. THE DOS SCREEN
  1902.  
  1903.     Zedit takes a snap shot of the DOS screen when it starts up
  1904.     and keeps it updated every time you execute a DOS command
  1905.     from within the editor.  
  1906.  
  1907.     The contents of the DOS screen can be viewed at any time the
  1908.     editor is idle (and not in a dialog or sub program such as
  1909.     the color editor) by holding down both the CTRL and ALT keys
  1910.     simultaneously or clicking and holding on the status bar.  
  1911.  
  1912.